home *** CD-ROM | disk | FTP | other *** search
/ APDL Eductation Resources / APDL Eductation Resources.iso / programs / database / powerbase / printlabel / !PrintLbls / !Help < prev    next >
Encoding:
Text File  |  1995-06-24  |  12.7 KB  |  268 lines

  1. ----------------------------------------------------------------------------
  2. File:           Help text file (ASCII)
  3. Date:           24th June 1995
  4. Application:    !PrintLbls
  5. Version:        1.20 (24th June 1995)
  6. Author:         Steven Haslam
  7. Purpose:        Label printing using outline fonts and RISC-OS PDrivers
  8. ----------------------------------------------------------------------------
  9.  
  10.         !PrintLbls I wrote to be able to print labels of a standard rather
  11. superior to draft printed labels usually found on mailshots, council letters
  12. etc. etc. The idea was to take a simply-structured file and convert it to
  13. labels that were in outline fonts, to allow maximal impression on
  14. recipients.
  15.  
  16.         I decided that it was best to use the outline fonts for this, and
  17. also to use the RISC-OS printer drivers, despite all the problems this may
  18. cause.
  19.  
  20.         I decided on Comma Separated Value files for input: this is fairly
  21. standard for many applications, and is easy to create and understand. (it is
  22. also incidentally the format for !1stMail merging)
  23.  
  24.         Version 0.90, which was uploaded to various bulletin boards and
  25. dated 23 May, was very poor and only just worked in a very limited fashion.
  26. It allowed user-selectable fonts for the first line, middle lies and last
  27. line. it also allowed the first line to be bigger (or smaller). However, it
  28. assumed that the user used the same labels as I did and that they set up the
  29. printer driver right! (This printer driver problem still exists).
  30.  
  31.         Then, I was sent a letter by someone who was having trouble with it,
  32. because they were using it on a two-stock label page with a laser printer.
  33. Therefore, I decided that since it might be used, it ought to be usable.
  34.  
  35.         Versions 1.00 and 1.10 came into being on the same day. Version 1.00
  36. allowed setting up by writing a text file containing the label measurements.
  37. In 1.10 (this afternoon) I added a window, sprite and icons so that
  38. measurements could be entered straight into the program.
  39.  
  40.         Version 1.11 allows the user to set the indentation per line,
  41. allowing labels to be printed with each line starting at the same position
  42. on the left. It is even possible to get the address to slope backwards by
  43. using a negative value. There has been some internal tidying up, including
  44. bugfixes if a ridiculous point size is entered, or no units are put on.
  45. Version 1.11 does not require that you open the window at any time if you
  46. have set up the options as you like them. I have also added an auto-revise
  47. option, which checks every second for a change in the list of fonts. If it
  48. finds a difference, it re-assembles the font menu. If you remove all the
  49. fonts, PrintLbls will complain!
  50.  
  51.     Version 1.12 uses version 2.00 of the sliding heap manager and hence can be used alongside applications such as PowerBase &c. that also use SlidingHeap 2.00. Also, the labels setup window now enforces that measurements (apart from those in points and millipoints) are given only to 3 signifcant figures: avoiding long trails of decimals that may occur when units are converted.
  52.  
  53.     Version 1.20 features error handling within the error handler (wow!), RiscOS 3 awareness (non-use of InterfaceManager, downloading/declaring fonts to PostScript printers) and allows the use of fractional point sizes (e.g. 11.5pt).
  54.  
  55. Using !PrintLbls
  56. ----------------
  57.  
  58.         The input file is a simple CSV file. Each 'record' for a single
  59. person (or other entity) is terminated by a 'null', e.g. a linefeed or a
  60. carraige return. Each line for the address is separated by a comma. If the
  61. first character of a line is character 34 (") then all commas are skipped
  62. until a second 34. This allows commas to occur in a line, and also fits in
  63. with many programs' idea of a CSV file.
  64.  
  65.         Here is an example record:
  66.  
  67. Steven Haslam,"112, Keighley Road",Colne,Lancashire,BB8 0PH
  68.  
  69.         In !Edit, each record would be a separate line in the file.
  70.  
  71.         The filetype can be either &FFF (text) or &DFE (offical CSV
  72. filetype)
  73.  
  74.         !PrintLbls is loaded by double-clicking on its icon in the Filer.
  75. When it has loaded it checks that some fonts are present, and if some are it
  76. checks them against the list it holds of fonts to be used. If any fonts are
  77. to be used that are not present, you will be informed and a present font
  78. will be substituted. (0.90 may have contained a font in itself that was
  79. added to the Path, this is not done with 1.10).
  80.  
  81.         So, you should now have the PrintLbls icon on your icon bar. Click
  82. on it with SELECT and you will get the main window. This contains: a load
  83. target for a CSV file, a box with information about the current printer
  84. driver, a 'Print' button, a box with information about the current fonts and
  85. a 'revise font list' button and also a 'Set up labels' button.
  86.  
  87.         To load a CSV file, drag it to the lad target (the large arrow). The
  88. text icon will change from "« None »" to the file name, or "Data from
  89. TaskName" if it has been dragged straight from a task (e.g. !Edit).
  90.  
  91.         If you have a printer driver installed, then you can 'press' the
  92. Print button and the labels will be printed through your printer driver. If
  93. all the labels can not be fitted onto one page, then more than one page will
  94. be used.
  95.  
  96.         Alternatively, if all your options have been set up as below, you
  97. can simply drag your CSV file to the icon on the icon bar. A confirmation
  98. box will ask you if you want to print it as the current printer resolution.
  99. Therefore you do not have to open the window at any time.
  100.  
  101.         It is unlikely that your labels will be the same size as they are by
  102. default, or that you will want the same font types & sizes as I use. To
  103. cahnge the label sizes, click on the 'Set up labels' button. This opens the
  104. setup window. It contains a diagrammatic sprite of the label relative the
  105. the top left of a page. The measurements are in writeable icons, click on
  106. them and use the keyboard to alter them. Allowed units are: "in", "pt", "mp"
  107. (millipoints), "mm" and "cm". All units are stored as millipoints
  108. internally, so rounding errors may occur when using millimetres or
  109. centimetres.
  110.  
  111.         You will also see two writeable icons for how many labels there are
  112. across and down the page. When printing, the program goes across before
  113. going down, so you can use half a page at first and then another half later.
  114.  
  115.         The 'Identation per line' icon allows the 'tabbing' of each line to
  116. be changed. I generally use 0.1 or 0.2 inches. Setting this to 0 makes each
  117. line start at the same place, setting it to a negative value allows the
  118. lines to slope backwards!
  119.  
  120.         There are three buttons at the bottom: 'Cancel' closes the window
  121. and makes no changes to theinternal variables, 'OK' closes the window and
  122. updates the internal variables as does 'Save' which also re-saves the
  123. configuration file.
  124.  
  125.         To set up the fonts, click MENU over the main window and go to
  126. sub-menu 'Fonts'. This leads to a submenu containing 'Name', 'Address' and
  127. 'Last line'. You can have a font for the name, a font for the address and a
  128. font for the last line (i.e. put the postcode {!} in bold). There are two
  129. writeable icons in the main window that control the size (in points) of the
  130. font used for the name and the address (including the last line). Presing
  131. 'Revise font list' rescans the fonts, useful if you load in more fonts while
  132. the program is still running.
  133.  
  134.         On the main window's menu is the option 'Remove CSV' which removes
  135. the CSV file from memory
  136.  
  137.         Also on the main window's menu is the sub-menu option 'Units'. This
  138. controls which units are used by default in the setup window. Notice that
  139. because clicking OK in the setup window changes the strings to real numbers,
  140. rounding error may occur if the window has been displayed in metric measure
  141. when the measurements are intended for imperial lengths. Notice that any
  142. measuring system can be used in the setup window, you can even combine
  143. points, millimetres, inches and centimetres all at the same time, although
  144. this is not good for your sanity!
  145.  
  146.         From the icon bar menu, there are three options: 'Info' leads to the
  147. standard info box, 'Save setup' re-saves the configuration file and 'Quit'
  148. has the expected effect.
  149.  
  150.         Information kept in the configuration file is as follows:
  151.  
  152.         The three font names, the two font sizes, the label measurements, the number of labels across and down, and the default units for the setup window. The 'setup' file (in the PrintLbls directory) is plain text.
  153.  
  154.         Here is an example file, the | is not part of the file, but denotes
  155. comments:
  156.  
  157. Homerton.Medium.Oblique | 'Name' font
  158. Homerton.Medium         | 'Address' font
  159. Homerton.Bold           | 'Last line' font
  160. 24 | 'Name' size (pt)
  161. 12 | 'Address' size (pt)
  162. 18000  | top margin (mp)
  163. 36000  | left margin (mp)
  164. 288000 | horizontal edge-to-edge (mp)
  165. 100800 | vertical edge-to-edge (mp)
  166. 14400  | identation per line (mp)
  167. 2  | labels on page horizontally
  168. 8  | labels on page vertically
  169. in | preferred units for setup window
  170.  
  171.         There is a problem with labels on dot matrix printers. Acorn's
  172. printer drivers are page-based. This is not a criticism of the printer
  173. drivers, it is entirely reasonable. However, most dot matrix printer labels
  174. are continuous rolls, perhaps with perforations every six labels or so.
  175. Therefore, it is best to define a special page size for them. It might also
  176. be necessary to define a separate printer for them, so that form feeds come
  177. out right: if the line feed value is 1/6th of an inch (70 line approx. on
  178. A4), then you will need to work out the amount of lines per page and add to
  179. job_prologue:
  180.  
  181.         "<27>C" and then the character for the number of lines. This makes
  182. the form feeding come out right. e.g. if it was 18 lines, do "<27>C<18>".
  183.  
  184.         RiscOS 3 printer drivers now have a way of defining this! You need
  185. to declare the text length of a page if you are using a DP-type printer.
  186.  
  187.         Because of its nature, this problem *only* occurs with continuous
  188. roll labels and sheets.
  189.  
  190.         I think that about sums it up! Please feel free to contact me with
  191. any problems or suggestions for mods. etc.
  192.  
  193. I can be contacted as:
  194.  
  195. Steven Haslam
  196. 112 Keighley Road,
  197. Colne,
  198. Lancashire,
  199. BB8 0PH
  200.  
  201. ****************************************************************************
  202.  
  203. BUG HISTORY (summary)
  204. -----------
  205.  
  206. 0.90- First released version (23/05/91)
  207. 1.00- Added definable label sizes as part of the 'setup' file. (17/11/91)
  208. 1.10- Added setup window for label sizes
  209.       Improved printing routine, made it faster (than 1.00 anyway)
  210.       Added multi-unit support
  211.       Took away error box from program, was causing trouble
  212. 1.11- Indentation level now changeable (15/12/91)
  213.       Took away second error box if 'ESCAPE' pressed during printing
  214.       Improved point size checking (made it work)
  215.       You don't have to enter units in setupW
  216.       You can now drag files to the icon bar
  217.       Fonts auto-revise
  218. 1.12- New SlidingHeap
  219.       Sig. figs. in label setup window
  220. 1.20- PDriver_DelcareFont calls added (for PostScript printing)
  221.       Templates3 file now used!
  222.       InterfaceManager module not needed for RiscOS 3 users (presumably most of you)
  223.       Error handler added within error handler
  224.       Font sizes now stored as reals, not integers. (24/6/95)
  225.  
  226. ****************************************************************************
  227.  
  228. CREDITS
  229. -------
  230.  
  231. I wrote !PrintLbls. I also wrote the memory manager (SlidingHeap). Interface
  232. Manager was written by SIMON HUNTIGDON. The printer drivers are copyright
  233. Acorn Computers and outline fonts are copyright whoever made them.
  234.  
  235. ****************************************************************************
  236.  
  237. PLUGS
  238. -----
  239.  
  240. If you have enjoyed using this product (ahem) perhaps you would like to know
  241. of other products I have written or co-written? This includes Powerbase, a
  242. fairly powerful tree-based database, which is already in semi-commercial use
  243. in running a sixth form college. Write to me at an address above.
  244.  
  245. ****************************************************************************
  246.  
  247. COPYRIGHT
  248. ---------
  249.  
  250. This program is copyright © 1991 Steven Haslam. However, I allow it to be
  251. Public Domain. You may copy it, give it to friends or upload it to bulletin
  252. boards as you please so long as (A) it is not altered in any way, except for
  253. tailoring of !Boot or !Run without me seeing it first, and (B) you do not do
  254. so for a profit. I reserve the right to withdraw its Public Domain status at
  255. any time at my own discretion. You are also allowed to use parts of this
  256. program in your own program as long as you inform me and give me suitable
  257. credit.
  258.  
  259. DISCLAIMER
  260. ----------
  261.  
  262. No warranty, express or implied, is given with this product, and I can not
  263. be held responsible for any damage to your health, wealth or marraige due to
  264. the action (or inaction) of this product. Use of it is done at entirely your
  265. own risk. All rights reserved.
  266.  
  267. ****************************************************************************
  268.